// Go作者版权所有。版权所有。
// 此源代码的使用受BSD样式的约束
// 可以在许可证文件中找到的许可证。

package sym

import (
	"cmd/internal/objabi"
	"cmd/internal/sys"
	"debug/elf"
)

// RelocVariant是重定位上的链接器内部变体。
type RelocVariant uint8

const (
	RV_NONE RelocVariant = iota
	RV_POWER_LO
	RV_POWER_HI
	RV_POWER_HA
	RV_POWER_DS

	// RV_390_DBL是一种s390x特定的重新定位变体，表明
	// 要放入可重定位字段的值应首先为
	// 除以2。
	RV_390_DBL

	RV_CHECK_OVERFLOW RelocVariant = 1 << 7
	RV_TYPE_MASK      RelocVariant = RV_CHECK_OVERFLOW - 1
)

func RelocName(arch *sys.Arch, r objabi.RelocType) string {
	// 我们在Go1.4中没有一些迁移类型。
	// 在引导代码中包含这些代码时取消注释代码。

	switch {
	case r >= objabi.MachoRelocOffset: // 马赫数
		// nr:=（r-机械加工偏移量）>>1
		// 开关ctxt.Arch.Family{
		// 案例sys.AMD64：
		// 返回macho.RelocTypeX86_64（nr.String）（）
		// 案例系统ARM：
		// 返回macho.RelocTypeARM（nr.String）（）
		// 案例sys.ARM64：
		// 返回macho.RelocTypeARM64（nr.String）（）
		// 案例sys.I386：
		// 返回macho.RelocTypeGeneric（nr.String）（）
		// 违约：
		// 恐慌（“无法触及”）
		// }
	case r >= objabi.ElfRelocOffset: // 精灵
		nr := r - objabi.ElfRelocOffset
		switch arch.Family {
		case sys.AMD64:
			return elf.R_X86_64(nr).String()
		case sys.ARM:
			return elf.R_ARM(nr).String()
		case sys.ARM64:
			return elf.R_AARCH64(nr).String()
		case sys.I386:
			return elf.R_386(nr).String()
		case sys.MIPS, sys.MIPS64:
			return elf.R_MIPS(nr).String()
		case sys.PPC64:
			return elf.R_PPC64(nr).String()
		case sys.S390X:
			return elf.R_390(nr).String()
		default:
			panic("unreachable")
		}
	}

	return r.String()
}
